home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / games / solit1_0.zip / MP_SOLIT.DOC < prev    next >
Text File  |  1996-11-09  |  15KB  |  321 lines
  1.                                                             November 9, 1996
  2.  
  3.                   Midnight Programmers' Solitaire '97 v1.0
  4.                   ----------------------------------------
  5.  
  6.  Disclaimer (Weazle words for the lawyers)
  7.  -----------------------------------------
  8. I bear no responsibilities for any unintentional mischief caused by this 
  9. humble program on your system.  If on some very remote chance that use of
  10. MP_SOLIT.EXE scrambles your computer, you are on your own with my humblest
  11. apologies.  I have taken all possible precautions to ensure that this
  12. program performs as designed but sometimes stuff happens.  (Read the official
  13. disclaimer at the bottom of this file.)
  14.  
  15. This version has been tested with:
  16.   80386DX33, 80486SX33, 80486DX2/66, 80486DX2/50 and Pentium 133 systems
  17.   under PCBoard 15.30, DESQview 2.62, BNU 1.70, Teleguard 3.02,
  18.   Windows 3.x, Windows 95, LANtastic 6.0 and Novell 3.12
  19.  
  20.   (It hasn't been tested on a Pentium Pro yet, care to donate one? <GRIN>)
  21.  
  22. Now that the nasty part is over with, here is the important stuff...
  23.  
  24.  Acknowledgments 
  25. ---------------------------------------------------------------------------
  26. Open Doors & Regkey     Brian Pirie
  27.                         117 Cedarock Drive,
  28.                         Kanata, ON  
  29.                         CANADA, K2M 2H5
  30.  
  31. Borland C++             Borland International, Inc.
  32.                         100 Borland Way,
  33.                         P.O. Box 660001,
  34.                         Scotts Valley, CA.
  35.                         USA, 95067-0001
  36.  
  37. PCBoard BBS             Clark Development Company, Inc.
  38.                         P.O. Box 571365,
  39.                         Murry, UT,
  40.                         USA, 84157-1365
  41.  
  42.  Thanks & Appreciation
  43.  ---------------------
  44. A tip'o the hat to Greg Contesti, sysop of Oasys as well as the members of
  45. The GameBoard BBS, Sysops of FIDO Net 244 and Craig Sturgeon for testing
  46. this software prior to full release.
  47.                         
  48.  Distribution Files
  49.  ------------------
  50. MP_SOLIT.EXE      - Main program (compiled for 80386 or better processor).
  51. MP_SOLIT.XT       - Alternate version of main program (compiled for 8086).
  52.                     Rename MP_SOLIT.XT to MP_SOLIT.EXE.
  53.                     Note: If you are running on a 386 or better, you can
  54.                           delete this file.  I only include it for old
  55.                           hardware compatibility.
  56. MP_SOLIT.CFG      - Standard configuration file.
  57. MP_SOLIT.BAT      - Sample launch file for most systems.
  58. MP_SOLIT.         - PCBoard specific launch file that I use.
  59. HISTORY.DOC       - Revision/release/bug fix history file.
  60. REGISTER.DOC      - Registration form (Pretty please?)
  61. FILE_ID.DIZ       - Short BBS description file.
  62. MP_SOLIT.DOC      - This readme file.
  63.  
  64.  Revisions
  65.  ---------
  66.  Please see HISTORY.DOC for complete revision/release/bug fix history.
  67.  
  68.  Known Problems and Other Weirdness
  69.  ----------------------------------
  70. Some modem's and/or software, cannot handle the club character (ASCII 5) and
  71. will not print it to the screen.  This is why the game asks if you can see
  72. the club character when loading.  If you select "N" then you get characters
  73. symbolizing the suits instead of the suit face.  This also kicks in some
  74. more keyboard draining routines while printing.  It seemed to be marginally
  75. related to the following known bug.
  76.  
  77. There is a known bug with some modems (O.K., Craig Sturgeons's lap top modem)
  78. that seems to return garbage while updating the screen.  I have taken all
  79. precautions I can to minimize this effect, but I never was able to completely
  80. eliminate it.  I'm beginning to suspect that it's a "feature" of Craig's
  81. machine & modem and that it doesn't like even slightly noisy phone lines.
  82.                                                                 
  83.  Functional Limitations
  84.  ----------------------
  85. The Solitaire '97 has not been crippled in any way, shape or form.  It does
  86. however include a delay when starting the program, begining a new game and
  87. exiting the program that will be removed by registering this program.  I
  88. guess you could call this nag-ware.
  89.  
  90. Also, unlike some other games, this one is fully multi-node aware,
  91. multi-tasker friendly (DESQview & Win95) and TESTED!
  92.  
  93.  Why?
  94.  ----
  95. Darn good question.  First off, this is not my first door, nor is it my
  96. first door in C, but it is my first with Brian Pirie's excellent BBS door
  97. library OpenDoors.  I have a couple of other large projects on the go that
  98. will be using OpenDoors and I wanted a smaller program to get a feel for the
  99. library, and get all the appropriate BBS door support functions built.
  100.  
  101. As my BBS (see below for all the info) didn't have a solitaire game I figured
  102. that this would be just the project to do all the testing.  I had intended to
  103. write my own registration key functions, but I was so happy with OpenDoors
  104. that I also purchased a RegKey license as well.
  105.  
  106.  Installation
  107.  ------------
  108. 1) Copy all the files in the ZIP file into a separate subdirectory.
  109.  
  110. 2) Edit MP_SOLIT or MP_SOLIT.BAT to point to the correct directories and
  111.    drop files.
  112.  
  113. 3) Add a call to the launching file (MP_SOLIT or MP_SOLIT.BAT) in your DOOR
  114.    description file.
  115.  
  116. 4) If you are running on a network don't forget to set the MP_SOLIT.EXE file
  117.    to READ ONLY.  For DOS, OS/2 and Win95:
  118.       ATTRIB *.EXE +R
  119.    For Novell:
  120.       FLAG *.EXE SRO
  121.  
  122. 5) That should be it... Start playing!
  123.  
  124. OpenDoors allows you to use almost any BBS door drop file type and COM port
  125. IRQ combinations.
  126.  
  127. If you have any problems or specific changes for your BBS system, please
  128. forward them to me.  I will include these recommendations in future release
  129. documentation.
  130.  
  131.  Files Created
  132.  -------------
  133. The first time the game is run the high score file (MP_SOLIT.DAT) will be
  134. created in the installation directory.  This is a data file and not an
  135. a ASCII readable file, so it isn't displayable.  I might be persuaded to
  136. add this as a feature for a future release if I get enough requests.
  137.  
  138. If you have any weird things happen, the game might write out a log file to
  139. the installation directory with information on what might have happened. This
  140. log file will be in the form "SOL_####.LOG" with the number signs being
  141. replaced with the node number that generated the error.
  142.  
  143. Please note, that the error messaging in this program is not extensive, so
  144. the information may not make sense or the error might not trigger a log
  145. entry at all.
  146.  
  147.  Playing Solitaire '97
  148.  ---------------------
  149. The object of this game is to move all the cards from the main board to the
  150. suits piles.
  151.  
  152. Scoring: The player is awarded a point for each card moved to the suits
  153.   columns.  If all cards are moved, the player is awarded a bonus based upon
  154.   the amount of time used (i.e. the faster you complete the game, more points
  155.   you get).
  156.  
  157. Movement: Card movement is accomplished by selecting the column you wish to
  158.   move a card from, to the column you want to move it to.  Each column has a
  159.   number above it or letter ("S" for Suits or "N" or Next for the next three
  160.   cards from the heap pile) to identify it.
  161.  
  162.   You can also move the cursor by using the "<" (left) and ">" (right)
  163.   characters to move to the next column and the enter key to select.
  164.  
  165.   The game will allow single cards, complete or partial columns to be moved.
  166.   You may only move a single card from the heap (Column 0) or to the Suits
  167.   columns.
  168.  
  169.   Cards cannot be moved from the Suits columns once they are there nor can
  170.   cards be moved to heap piles from the main tableau.
  171.  
  172.   There is no limitation on how many times you can flip the heap pile.
  173.  
  174. Help: There is limited on-line help available by hitting the H key.
  175.  
  176. Refreshing the Screen: Should bad phone lines scramble the screen, the R
  177.   command (Refresh) will redraw the entire screen.
  178.  
  179. Quitting: Hitting "Q" (for Quit) will allow the user to end a current game,
  180.   as well as exiting back to the BBS.  If the score is good enough to make
  181.   it on the high score you will be shown the new standings before exiting.
  182.  
  183.  Resetting Scores
  184.  ----------------
  185. Just delete the MP_SOLIT.DAT file from the installation directory.  A new,
  186. blank data file will be created the next time that someone plays the game.
  187.  
  188.  Registration
  189.  ------------
  190. This program is _NOT_ Freeware nor is it Public Domain software.  You are
  191. allowed a 30 day evaluation period, after which you are required to register
  192. this software.
  193.  
  194. Registration for this program is $10.00 (Canadian or US funds).  If you find
  195. this program entertaining please make the effort to register it, so I can be
  196. persuaded to write more stuff!  After all, isn't that what Shareware is all
  197. about.
  198.  
  199. Please fill out REGISTER.DOC and mail it in.
  200.  
  201. Once you receive your registration key, edit the "MP_SOLIT.CFG" file
  202. replacing the information for the following entries with the appropriate
  203. string in your registration file:
  204.  
  205.       RegistrationName   Unregistered
  206.       RegistrationCode   00000
  207.  
  208. Please note that the RegistrationCode entry is not case sensitive but both
  209. the RegistrationName and the RegistrationCode must be entered EXACTLY as was
  210. the information you submitted for registration.
  211.  
  212.  Where to Contact Midnight Programmers
  213.  -------------------------------------
  214.   Address:  Midnight Programmers
  215.             1589 Waterdown Road,
  216.             Burlington, Ontario,
  217.             Canada, L7R 3X5
  218.  
  219.   BBS:      The GameBoard BBS
  220.             (905) 689-3982  (300-28800 v.34)
  221.             (905) 689-9409  (300-28800 v.34)
  222.  
  223.   FidoNet:  Mark Collis@1:244/506
  224.   InterNet: Mark.Collis@gboard.gryn.org
  225.             mcollis@worldchat.com
  226.             mark_collis@dofasco.ca
  227.  
  228.  Other Midnight Programmer files - FREQ names
  229.  --------------------------------------------
  230. SOLITAIRE - Standard solitaire card game - BBS door. (Shareware)
  231. QOTD      - Over 5600 random quotes, DOS EXE, PPE, and BBS DOOR versions 
  232.             included. (Freeware)
  233. WAIT      - Wait a set time and return a DOS error level if ESC hit.
  234.             (Freeware)
  235. DRBOB     - A talk with a Elisa like psychiatrist - BBS DOOR. (Freeware)
  236. NACONVERT - Converts a FIDONET.NA file into a displayable conference list.
  237.             (Freeware)
  238. FIXPHONE  - LoopBack CALLBACK.FON maintenance utility (PCBOARD only).  PPS
  239.             source code and complied PPE included. (Freeware)
  240.  
  241.  Who are Midnight Programmers?
  242.  -----------------------------
  243.  
  244. Right off the top, we are not a "_Midnight_Autoparts_" dealing in hot CPU's,
  245. nor do we dabble in illegal software tampering, and piracy.  We do this for
  246. fun, for the challenge and to learn more about these machines that seem to
  247. take up so much of our free time (yeah, sick puppies ain't we.)
  248.  
  249. The name has been stuck to a group of friends that have contributed to a
  250. number of programming projects over the last couple of years, with code,
  251. ideas, suggestions, testing, food, drink, books and moral support.  I've
  252. usually been the instigator and main coder, but not always.  Some of us are
  253. professionals in the field and some of us are hobbyists that have gotten out
  254. of control (just ask Alan, he'll tell you I've been out of control for
  255. years).
  256.  
  257. Why "Midnight Programmers" and not "Tea Time Programmers"?  Well, if you've
  258. ever done any programming or system maintenance you'll know what I mean.
  259. It's usually late at night that things go wrong and require fixing, or you
  260. lose track of time while putting in just one more feature and look up to
  261. find that it's 2:30 am (and you have to be in for work at 8:00 am!)
  262.  
  263. Over the last little while with all the over the phone rescue missions, 
  264. I've strongly considered changing names to "Remote Control Consultants" 
  265. <GRIN>, but Midnight Programmers seems to have stuck, and describes this 
  266. loose group computer jockeys quite nicely, thank you very much.
  267.  
  268. Thanks for reading this far....
  269.  
  270.   Mark Collis
  271.  
  272.  
  273. ----------------------------------------------------------------------------
  274. THE FOLLOWING INFORMATION APPLIES TO ALL MIDNIGHT PROGRAMMERS SOFTWARE
  275. PROGRAMS:
  276.  
  277. DISTRIBUTION
  278.  
  279. You may make this file available for downloading from your BBS or you may
  280. upload it to any BBS of your choice, provided that you do not make any
  281. changes to the contents of the archive (ZIP file). 
  282.  
  283. ----------------------------------------------------------------------------
  284. TO REGISTER, PLEASE FIND ENCLOSED IN THIS ARCHIVE THE FILE REGISTER.DOC.
  285. READ AND FILL IT OUT, SEND IT TO THE ADDRESS IN THE REGISTER.DOC WITH
  286. PROPER REGISTRATION MONEY AND YOUR REGISTRATION WILL BE PROMPTLY SENT TO
  287. YOU ACCORDING TO THE METHOD CHECKED ON THE REGISTRATION FORM.
  288. ----------------------------------------------------------------------------
  289.  
  290. Licensing Agreement
  291. ===================
  292. You are hereby granted a license to use, share, copy, and distribute the
  293. accompanying program and its documentation, provided that this notice, and
  294. the copyright information are not removed and/or altered in any way or form.
  295. No fee or consideration is to be charged for the distribution. The
  296. accompanying program is provided on an AS-IS basis without warranty of any
  297. kind expressed or implied. The entire risk as to quality and performance of 
  298. the accompanying program rests solely with the user. In no event will the 
  299. author be liable for any damages, consequential or inconsequential.
  300.  
  301. By loading and running the accompanying program you acknowledge you have
  302. read and understand this agreement and agree to be bound by its terms and
  303. conditions.
  304.  
  305. The registered version of this program may only be run on the BBS it is
  306. registered to. The sysop may run as many copies on that BBS as s/he would
  307. like. Keys are not to be given out to others.
  308.  
  309. LEGALITIES
  310.  
  311. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  312. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  313. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  314. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  315. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  316. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
  317. DISTRIBUTION OF THE REGISTRATION KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE
  318. VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
  319. A REGISTERED KEY CODE WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  320. ----------------------------------------------------------------------------
  321.